home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / dmania25.zip / DMANIA.DOC < prev    next >
Text File  |  1992-07-02  |  14KB  |  369 lines
  1.  
  2.  
  3.                        ============================
  4.                                Dollarmania!
  5.                        ============================
  6.                            (c)1992 T&J Software
  7.  
  8.         One of the T&J Software Collection of multi-BBS door programs.
  9.            Supporting PCBoard, Wildcat!, Gap, QBBS, RBBS, Spitfire,
  10.               UltraBBS, Telegard, TriBBS, Remote Access, and WWIV
  11.  
  12.                        VERSION 2.50     07/02/92
  13.  
  14.                                    By
  15.  
  16.                                Tom Wildoner
  17.                              397 West Broadway
  18.                               Jim Thorpe, PA
  19.                                   18229
  20.                             VOICE (717)325-9480
  21.                    *between 5:30 & 10:00 p.m. Eastern Time
  22.  
  23.                                   From
  24.  
  25.                                The T&J BBS
  26.                               (717)325-9481
  27.                         1200/2400/9600/19200/38400
  28.                                24 Hours/Day
  29.  
  30. LATEST VERSION:
  31. ===============
  32.  
  33. Please call the T&J BBS for the latest version of this program.
  34.  
  35. LEGALITIES:
  36. ===========
  37.  
  38. THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS" WITHOUT
  39. WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO ANY
  40. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  41. IN NO EVENT SHALL ANYONE INVOLVED WITH THE CREATION AND PRODUCTION OF THIS
  42. PRODUCT BE LIABLE FOR INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING
  43. OUT OF ANY USE THEREOF OR BREACH OF ANY WARRANTY.
  44.  
  45. DISTRIBUTION:
  46. =============
  47.  
  48. You may make this file available for downloading from your BBS or you may
  49. upload it to any BBS of your choice, provided that you do not make any
  50. changes to the contents of the archive (ZIP file). The archive and its
  51. individual contents may not be used by any service that charges any money
  52. whatsoever, without the written permission of the author.
  53.  
  54. PROGRAM DESCRIPTION:
  55. ====================
  56.  
  57. Dollarmania! is a simple slot machine door program -- players can enter
  58. from one to ten coins (in STANDARD mode) or any dollar amount thet
  59. want (in CUSTOM mode). The two modes are sysop configurable in the
  60. SETUP sub-program. Online help, payoff tables and the alltime high
  61. scorer information is available while the user is in the door. The
  62. jackpot, player starting money and number of attempts per day is all
  63. sysop configurable!
  64.  
  65. At the conclusion of play, the door also creates a top ten score file,
  66. both color and mono. The door resets automatically every Monday with
  67. the help of a maintenance program which is built-in to the main
  68. Dollarmania! program.
  69.  
  70. The jackpot increases $5 per play when setup in the STANDARD mode and
  71. $100 per play when setup in the CUSTOM mode.
  72.  
  73. If the users spends all of his/her money, he cannot play again until
  74. Monday when the door resets!
  75.  
  76. NOTE:
  77. =====
  78.  
  79. The DMANIA.KEY file that is distributed with this door does NOT expire!
  80. This is simply here so the door has a KEY to read. When you register,
  81. you will receive a new DMANIA.KEY file.
  82.  
  83. Your users will only be allowed 10 attempts per day until the door is
  84. registered.
  85.  
  86. Running the door locally (DMANIA LOCAL) will let you evaluate the
  87. door with no crippling effects. You get the total turns that you have
  88. the door configured for.
  89.  
  90.  
  91. FEATURES:
  92. =========
  93.            --- Desqview Aware.
  94.            --- COM1-4 support and non-standard IRQ's.
  95.            --- Colorful ANSI screens.
  96.            --- Chat function.
  97.            --- NO BRUN module needed for play.
  98.            --- BETA tested on five different boards.
  99.            --- Will return to BBS on dropped carrier.
  100.            --- Will TIMEOUT a player after 5 minutes of no activity.
  101.            --- Use of HOT KEYS while in the door.
  102.            --- Support BBS available.
  103.            --- STANDARD and CUSTOM mode available.
  104.            --- The jackpot is progressive.
  105.            --- A log file that shows who entered the game.
  106.  
  107.  
  108. INSTALLATION: (using the DMANIA SETUP command)
  109. ===============================================
  110.  
  111. Run Dollarmania! using the command string SETUP (i.e.  DMANIA SETUP)
  112.  
  113.      Just type:  DMANIA SETUP
  114.  
  115. You will be presented with five options:
  116.  
  117.     1.] Reset the door.
  118.     2.] Setup your DMANIA.CFG file.
  119.     3.] Setup your SYSOP.CFG file.
  120.     4.] Reset the ALLTIME high score file.
  121.     5.] Quit.
  122.  
  123. Let's start with number one and reset the entire door from scratch!
  124.  
  125. Now, select number two to setup the DMANIA.CFG file. Just answer all
  126. the questions that are presented.
  127.  
  128. Now, select number three to setup your SYSOP.CFG file. You will be asked
  129. the following questions:
  130.  
  131.     --- Starting jackpot amount.
  132.     --- Number of tries per day.
  133.     --- Starting cash.
  134.     --- CUSTOM or STANDARD mode.
  135.     --- PATH to color bulletin.
  136.     --- PATH to mono bulletin.
  137.  
  138. These are further explained in the SETUP sub-program.
  139.  
  140.  
  141. CONFIGURATION:
  142. =============
  143.  
  144. Example configuration file for PCBOARD.SYS
  145. ------------------------------------------
  146.  
  147. C:\PCB\PCBOARD.SYS  <=-  (Full pathname of your PCBOARD.SYS file)
  148. T&J Software        <=-  (Change this to your BBS name)
  149. Tom                 <=-  (The Sysop's first name)
  150. Wildoner            <=-  (The Sysop's last name)
  151.  
  152. Example configuration file for USERS.SYS
  153. ----------------------------------------
  154.  
  155. C:\PCB\USERS.SYS    <=-  (Full pathname of your USERS.SYS file)
  156. T&J Software        <=-  (Change this to your BBS name)
  157. Tom                 <=-  (The Sysop's first name)
  158. Wildoner            <=-  (The Sysop's last name)
  159.  
  160. Example configuration file for DOOR.SYS
  161. ---------------------------------------
  162.  
  163. C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
  164. T&J Software        <=-  (Change this to your BBS name)
  165. Tom                 <=-  (The Sysop's first name)
  166. Wildoner            <=-  (The Sysop's last name)
  167.  
  168. Example configuration file for USERINFO.DAT
  169. -------------------------------------------
  170.  
  171. C:\BBS\USERINFO.DAT <=-  (Full pathname of your USERINFO.DAT file)
  172. T&J Software        <=-  (Change this to your BBS name)
  173. Tom                 <=-  (The Sysop's first name)
  174. Wildoner            <=-  (The Sysop's last name)
  175. NOTE: DOOR.SYS must be in the SAME directory as USERINFO.DAT
  176.  
  177. Example configuration file for CALLINFO.BBS
  178. -------------------------------------------
  179.  
  180. C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
  181. T&J Software        <=-  (Change this to your BBS name)
  182. Tom                 <=-  (The Sysop's first name)
  183. Wildoner            <=-  (The Sysop's last name)
  184.  
  185. Example configuration file for DORINFOx.DEF
  186. -------------------------------------------
  187.  
  188. C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
  189.                           where 'x' is the BBS Node number.
  190. T&J Software        <=-  (Change this to your BBS name)
  191. Tom                 <=-  (The Sysop's first name)
  192. Wildoner            <=-  (The Sysop's last name)
  193.  
  194. Example configuration file for SFDOORS.DAT
  195. ------------------------------------------
  196.  
  197. C:\BBS\SFDOORS.DAT  <=-  (Full pathname of your SFDOORS.DAT file)
  198. T&J Software        <=-  (Change this to your BBS name)
  199. Tom                 <=-  (The Sysop's first name)
  200. Wildoner            <=-  (The Sysop's last name)
  201.  
  202. Example configuration file for CHAIN.TXT
  203. ----------------------------------------
  204.  
  205. C:\BBS\CHAIN.TXT    <=-  (Full pathname of your CHAIN.TXT file)
  206. T&J Software        <=-  (Change this to your BBS name)
  207. Tom                 <=-  (The Sysop's first name)
  208. Wildoner            <=-  (The Sysop's last name)
  209.  
  210. Example configuration file for GTUSER.BBS
  211. -----------------------------------------
  212.  
  213. C:\BBS\GTUSER.BBS   <=-  (Full pathname of your GTUSER.BBS file)
  214. T&J Software        <=-  (Change this to your BBS name)
  215. Tom                 <=-  (The Sysop's first name)
  216. Wildoner            <=-  (The Sysop's last name)
  217. 1                   <=-  (COM port number - defaults to 1)
  218. 1                   <=-  (Node number - defaults to 1)
  219.  
  220. Example Batch File
  221. ==================
  222.  
  223. A sample batch file is included and is similer to the following:
  224.    ECHO OFF
  225.    CD\DOORS\ONLINE          <=- Switch to the door's Directory.
  226.    DMANIA DMANIA.CFG        <=- Execute the door program and pass the
  227.                                 configuration filename to the program.
  228.    CD\PCB                   <=- Go back to PCB DIR when user exits door.
  229.    BOARD                    <=- Restart BBS.
  230.  
  231.  
  232. This Door is multi-node  compatible so you may run more than 1 node from
  233. the same .CFG file provided the path to your system file (DORINFOx.DEF,
  234. CALLINFO.BBS, etc) is exactly the same unless you are using environment
  235. variables, (q.v.)
  236.  
  237. Normally, when running multinode, just setup different DMANIA.CFG files
  238. for each node:   DMANIA1.CFG   DMANIA2.CFG  etc....
  239.  
  240. Environment Variables
  241. =====================
  242.  
  243. PCBoard automatically creates the %PCBDRIVE% & %PCBDIR% environment
  244. variables. Non-PCBoard systems may also use these variables by including
  245. the following in either your BBS batch or AUTOEXEC.BAT
  246.   SET PCBDRIVE=C:               <- Drive letter of your BBS files
  247.   SET PCBDIR=\BBSDIR            <- Path to your BBS files
  248. Then in your Door .CFG file instead of putting C:\BBSDIR\DOOR.SYS, you
  249. would put %PCBDRIVE%%PCBDIR%\DOOR.SYS. This allows you to use just one
  250. .CFG file for multi-node operation!
  251.  
  252. To specify a non-standard IRQ, put the IRQ number after the .CFG on the
  253. command line.  For example:
  254.  
  255.      DMANIA DMANIA.CFG /5
  256. or using the PCBDRIVE procedure:   SET IRQ=5   and use
  257.      DMANIA DMANIA.CFG /%IRQ%
  258.  
  259. This tells the program to use IRQ 5 instead of the standard IRQ.
  260.  
  261.  
  262. Sysop Keys
  263. ==========
  264.  
  265. F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
  266.          written to DOOR.SYS and USERS.SYS
  267. F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
  268.          and/or written to DOOR.SYS and USERS.SYS
  269. F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
  270. F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
  271.          and/or written to DOOR.SYS and USERS.SYS
  272. F8    -  Returns the caller involuntarily to the BBS.
  273. F9    -  Toggles the local display On/Off. Value is passed to PCBoard
  274.          and/or written to DOOR.SYS and USERS.SYS
  275. F10   -  Activates SysOp CHAT mode within the DOOR.
  276. ESC   -  Deactivates CHAT mode.  DOOR is resumed.
  277. UP    -  Give the caller extra time while in the DOOR.  
  278. DN    -  Subtract time from the caller while in the DOOR. 
  279. HOME  -  HELP key for Status Line options.
  280. ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
  281. ALT-X -  PCBoard will exit after current caller logs off. Value is
  282.          passed to PCBoard. Not available on non-PCBoard systems.
  283.  
  284. PROBLEMS:
  285. ========
  286.  
  287. If any internal errors do occur, check for a file called DFRAME.ERR
  288. and let me know what the error code says.
  289.  
  290. Several people have been having problems with their Trident SVGA
  291. cards and the ANSI screens not showing up correctly. To fix this,
  292. check you utility disk that came with your Trident card for a program
  293. called TANSI.SYS or something similar. Replace your old ANSI.SYS
  294. with this version of it. This will correct the problems.
  295.  
  296. Several people have had problems running some of the doors under
  297. Livecat. Try copying your user information files to the Dollarmania
  298. sub-directory and then telling Dollarmania to look for them there.
  299. Add something like this to beginning of your door batch file:
  300.  
  301.        COPY C:\WC30\WCWORK\NODE1\DOOR.SYS C:\WC30\DOOR\DMANIA
  302.  
  303. Don't forget to change line one in your DMANIA.CFG file to reflect
  304. the new location of the DOOR.SYS file.
  305.  
  306. Please feel free to contact me if you have any problems at all.
  307.  
  308.  
  309. MAINTENANCE:
  310. ===========
  311.  
  312. Nightly maintenance is required for this door. It's needed to determine
  313. if the current day is Monday. If it is, the door will reset all the
  314. player records and the bulletins. All users will now get a fresh start.
  315. The jackpot does not get reset! The jackpot will continue to grow until
  316. somebody wins it, then it gets reset.
  317.  
  318. To run the maintenance program, just run Dollarmania with the MAINT
  319. command string as part of your nightly maintenance:
  320.  
  321.        --- Switch to the Dollarmania directory
  322.        --- Run --->  DMANIA MAINT
  323.  
  324.  
  325. RUNNING LOCALLY:
  326. ===============
  327.  
  328. To run in LOCAL mode simply type DMANIA LOCAL
  329.  
  330.  
  331. UPGRADING:
  332. ==========
  333.  
  334. If you are upgrading from a previous version of Dollarmania!, reinstall
  335. this version from scratch.
  336.  
  337.  
  338. FUTURE VERSIONS:
  339. ================
  340.  
  341. --->> Let me know what you would like to see added!!
  342.  
  343.  
  344. VERSION HISTORY:
  345. ===============
  346. Version 1.00 ......... First release. 01/22/92
  347. Version 1.10 ......... Corrected bug that prevented SysOp's running a
  348.                        BBS with no locked com port from using the door.
  349. Version 2.00 ......... Switched door writing code to DoorFrame.
  350.                        02/20/92
  351. Version 2.10 ......... Recompiled using newest door writing routines,
  352.                        added internal maintenance, and added new bulletins.
  353.                        04-17-1992
  354. Version 2.50 ......... Recompiled using the newest door rotuines, switched
  355.                        to an external maintenance program, added support
  356.                        for STANDARD or CUSTOM modes of play, new bulletins,
  357.                        door resets every Monday, added support to play the
  358.                        door locally with no crippling, screens updated,
  359.                        added alltime high score screen for the users to
  360.                        view. 07-02-1992
  361.  
  362. REGISTERING:
  363. ============
  364. That's all there is to it! If you have any problems or questions
  365. please feel free to call the T&J BBS at (717)325-9481 and join the
  366. T&J Software Conference.
  367.  
  368. See the enclosed registration form for ordering!  (REGISTER.TXT)
  369.